### IDirectDrawSurface3::GetPalette

The IDirectDrawSurface3::GetPalette method retrieves the DirectDrawPalette structure associated with this surface and increments the reference count of the returned palette.

HRESULT GetPalette(

LPDIRECTDRAWPALETTE FAR *lplpDDPalette

);

##### Parameters

lplpDDPalette
  Address of a pointer to a DirectDrawPalette structure associated with this surface. This parameter will be set to NULL if no DirectDrawPalette structure is associated with this surface.

##### Return Values

If the method succeeds, the return value is DD_OK.

If the method fails, the return value may be one of the following error values:

DDERR_GENERIC
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_NOEXCLUSIVEMODE
DDERR_NOPALETTEATTACHED
DDERR_SURFACELOST
DDERR_UNSUPPORTED

##### See Also

IDirectDrawSurface3::SetPalette