Метод IGetClusterObjectInfo::GetObjectName (cluadmex.h)
[Этот метод доступен для использования в операционных системах, указанных в разделе Требования. Поддержка этого метода была удалена в Windows Server 2008.]
Возвращает имя объекта кластера.
Синтаксис
HRESULT GetObjectName(
[in] LONG lObjIndex,
[out] BSTR lpszName,
[in, out] LONG *pcchName
);
Параметры
[in] lObjIndex
Число, представляющее отсчитываемый от нуля индекс целевого объекта. Значение lObjIndex ограничено числом, которое можно получить, вызвав IGetClusterDataInfo::GetObjectCount.
[out] lpszName
Указатель на строку Юникода, заканчивающуюся null, которая содержит имя объекта, связанного с lObjIndex. Параметр lpszName может иметь значение NULL, указывая, что вызывающий объект запрашивает только длину имени. Хотя этот параметр объявлен как BSTR, этот параметр реализуется как LPWSTR.
[in, out] pcchName
На входных данных указатель на количество символов в буфере, на который указывает параметр lpszName . Параметр pcchName не может иметь значение NULL. В выходных данных указатель на количество символов в имени, хранящихся в содержимом lpszName, включая завершающий символ NULL.
Возвращаемое значение
Если getObjectName не выполнен успешно, он может вернуть другие значения HRESULT .
| Возвращаемый код или значение | Описание |
|---|---|
|
Операция выполнена успешно. |
|
Один или несколько параметров недопустимы. |
|
Буфер, на который указывает lpszName, слишком мал для хранения запрошенного имени. GetObjectName возвращает необходимое количество символов в содержимом pcchName. |
Комментарии
Если параметр lpszName указан как NULL, метод GetObjectName возвращает NOERROR.
Требования
| Минимальная версия клиента | Ни одна версия не поддерживается |
| Минимальная версия сервера | Windows Server 2003 Корпоративная, Windows Server 2003 Datacenter |
| Целевая платформа | Windows |
| Header | cluadmex.h |