IGetClusterObjectInfo::GetObjectName method

[This method is available for use in the operating systems specified in the Requirements section. Support for this method was removed in Windows Server 2008.]

Returns the name of a cluster object.


HRESULT GetObjectName(
  LONG lObjIndex,
  BSTR lpszName,
  LONG *pcchName



A number representing the zero-based index of the target object. lObjIndex is restricted to the number that can be retrieved by calling IGetClusterDataInfo::GetObjectCount.


Pointer to a null-terminated Unicode string containing the name of the object associated with lObjIndex. The lpszName parameter can be NULL, indicating that the caller is requesting only the name length. Although declared as a BSTR, this parameter is implemented as an LPWSTR.


On input, pointer to the count of characters in the buffer pointed to by the lpszName parameter. The pcchName parameter cannot be NULL. On output, pointer to the count of characters in the name stored in the content of lpszName, including the NULL-terminating character.

Return Value

If GetObjectName is not successful, it can return other HRESULT values.


If the lpszName parameter is specified as NULL, the GetObjectName method returns NOERROR.


Windows version None supported Windows Server 2003 Enterprise, Windows Server 2003 Datacenter
Target Platform Windows
Header cluadmex.h

See Also