IDirectXFileObject::GetName method

Retrieves a pointer to a DirectX file object's name. Deprecated.

Syntax

HRESULT GetName(
  [out]     LPSTR   pstrNameBuf,
  [in, out] LPDWORD pdwBufLen
);

Parameters

pstrNameBuf [out]

Type: LPSTR

Pointer to the buffer in which the DirectX file object's name will be copied. Set to NULL if only the buffer length is needed.

pdwBufLen [in, out]

Type: LPDWORD

Pointer to a DWORD specifying the length of the buffer pointed to by pstrNameBuf. The pdwBufLen parameter value will be modified to the buffer length needed to hold the object's name even if pstrNameBuf is NULL. In either case, the function will return DXFILEERR_BADVALUE if the original value of pdwBufLen is not as large as or larger than the length needed to hold the object's name.

Return value

Type: HRESULT

If the method succeeds, the return value is DXFILE_OK. If the method fails, the return value can be one of the following values.DXFILEERR_BADALLOC DXFILEERR_BADVALUE

Requirements

Requirement Value
Header
DXFile.h
Library
D3dxof.lib

See also

IDirectXFileObject