Поделиться через


Метод IGetClusterUIInfo::GetClusterName (cluadmex.h)

[Этот метод доступен для использования в операционных системах, указанных в разделе Требования. Поддержка этого метода была удалена в Windows Server 2008.]

Возвращает имя кластера.

Синтаксис

HRESULT GetClusterName(
  [out]     BSTR lpszName,
  [in, out] LONG *pcchName
);

Параметры

[out] lpszName

Указатель на строку Юникода, завершающуюся значением NULL, содержащую имя кластера, или значение NULL , указывающее, что вызывающий объект запрашивает только длину имени. Хотя этот параметр объявлен как BSTR, этот параметр реализуется как LPWSTR.

[in, out] pcchName

На входных данных указатель на количество символов в буфере, на который указывает параметр lpszName . В выходных данных указатель на общее количество символов в буфере, включая символ конца NULL.

Возвращаемое значение

Если getClusterName не выполнен успешно, он может вернуть другие значения HRESULT .

Возвращаемый код или значение Описание
NOERROR
0
Операция выполнена успешно.
E_INVALIDARG
0x80070057
Один или несколько параметров недопустимы.
HRESULT_FROM_WIN32(ERROR_MORE_DATA)
0x800700ea
Буфер, на который указывает lpszName, слишком мал для хранения запрошенного имени. GetClusterName возвращает необходимое количество символов в содержимом pcchName.

Комментарии

Если параметру lpszName присвоено значение NULL , а параметру pcchName не присвоено значение NULL, метод GetClusterName возвращает noERROR.

Требования

Требование Значение
Минимальная версия клиента Ни одна версия не поддерживается
Минимальная версия сервера Windows Server 2003 Корпоративная, Windows Server 2003 Datacenter
Целевая платформа Windows
Header cluadmex.h

См. также раздел

IGetClusterUIInfo