Функция GetClusterNetworkId (clusapi.h)

Статья
03/08/2023

Возвращает идентификатор сети. Тип PCLUSAPI_GET_CLUSTER_NETWORK_ID определяет указатель на эту функцию.

Синтаксис

DWORD GetClusterNetworkId(
  [in]      HNETWORK hNetwork,
  [out]     LPWSTR   lpszNetworkId,
  [in, out] LPDWORD  lpcchName
);

Параметры

[in] hNetwork

Дескриптор в сеть.

[out] lpszNetworkId

Указатель на идентификатор сети, связанной с hNetwork, включая символ конца null.

[in, out] lpcchName

Указатель на размер буфера lpszNetworkID в виде количества символов. На входных данных укажите максимальное число символов, которые может содержать буфер, включая завершающее значение NULL. В выходных данных указывает количество символов в результирующем имени, за исключением завершающего значения NULL.

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

Если операция выполнена успешно, функция возвращает ERROR_SUCCESS.

Если операция завершается сбоем, функция возвращает код системной ошибки. Ниже приведено одно из возможных значений.

Код возврата	Описание
ERROR_MORE_DATA	Буфер, на который указывает lpszNetworkID , недостаточно велик для хранения результата. Параметр lpcchNetworkID возвращает количество символов в результате, за исключением завершающего значения NULL.

Обратите внимание, что lpcchNetworkID относится к числу символов, а не к числу байтов, а возвращаемый размер не включает завершающее значение NULL в счетчике. Дополнительные сведения о размерах буферов см. в разделе Соглашения о размере данных.

Требования

Требование	Значение
Минимальная версия клиента	Ни одна версия не поддерживается
Минимальная версия сервера	Windows Server 2008 Корпоративная, Windows Server 2008 Datacenter
Целевая платформа	Windows
Header	clusapi.h
Библиотека	ClusAPI.lib
DLL	ClusAPI.dll

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

OpenClusterNetwork

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