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.

Syntax

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

Parameters

lObjIndex

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.

lpszName

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.

pcchName

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.

Remarks

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

Requirements

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

See Also

IGetClusterDataInfo::GetObjectCount

IGetClusterObjectInfo