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

Метод IGetClusterResourceInfo::GetResourceNetworkName (cluadmex.h)

  • Статья

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

Возвращает имя сети , управляемой ресурсом имя сети , от которого зависит ресурс .

Синтаксис

BOOL GetResourceNetworkName(
  [in]      LONG  lObjIndex,
  [out]     BSTR  lpszNetName,
  [in, out] ULONG *pcchNetName
);

Параметры

[in] lObjIndex

Число, представляющее отсчитываемый от нуля индекс целевого ресурса. Целевой ресурс может зависеть от ресурса сетевого имени. Значение lObjIndex ограничено числом, которое можно получить, вызвав метод IGetClusterDataInfo::GetObjectCount.

[out] lpszNetName

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

[in, out] pcchNetName

Указатель на максимальное число символов буфера, на который указывает lpszNetName. На входных данных это значение должно быть достаточно большим, чтобы содержать MAX_COMPUTERNAME_LENGTH + 1 символ. В выходных данных pcchNetName указывает на фактическое количество символов, скопированных в содержимое lpszNetName.

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

Возвращаемый код/значение Описание
TRUE
1
 Ресурс, индексирующийся lObjIndex , зависит от ресурса сетевого имени , и имя сети было успешно возвращено.
FALSE
0
 Ресурс, индексируется с помощью lObjIndex , не имеет зависимости от ресурса сетевого имени.

Комментарии

Метод GetResourceNetworkName необходим, чтобы разрешить страницы свойств расширения администратора отказоустойчивого кластера , чтобы определить, имеется ли у ресурса существующая или ожидающая зависимость от ресурса сетевого имени.

Имя сети хранится в частном свойстве Имя сети ресурса Имя сети. Общее свойство Имя ресурса сетевого имени — это имя ресурса, а не сети.

MAX_COMPUTERNAME_LENGTH является константой, определенной как 15 в файле заголовка Windows WinBase.h.

Требования

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

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

IGetClusterDataInfo::GetObjectCount

IGetClusterResourceInfo