Microsoft DirectX 8.1 (C++)

IDirectXFileObject::GetName

Retrieves a pointer to a Microsoft® DirectX® file object's name. 

HRESULT GetName(
  LPSTR pstrNameBuf,
  LPDWORD pdwBufLen
);

Parameters

pstrNameBuf
[out] Pointer to the buffer in which the Microsoft® DirectX® file object's name will be copied. Set to NULL if only the buffer length is needed.
pdwBufLen
[in, out] 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 Values

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

Applies To

This method applies to the following interfaces, which inherit from IDirectXFileObject.

Requirements

  Header: Declared in Dxfile.h.
  Import Library: Use D3dxof.lib.