Структура COSERVERINFO (objidl.h)

Статья
08/25/2023

Определяет ресурс удаленного компьютера для функций активации.

Синтаксис

typedef struct _COSERVERINFO {
  DWORD      dwReserved1;
  LPWSTR     pwszName;
  COAUTHINFO *pAuthInfo;
  DWORD      dwReserved2;
} COSERVERINFO;

Члены

dwReserved1

Этот элемент зарезервирован и должен иметь значение 0.

pwszName

Имя компьютера.

pAuthInfo

Указатель на структуру COAUTHINFO для переопределения безопасности активации по умолчанию для удаленных активаций компьютера. В противном случае задайте значение NULL , чтобы указать, что следует использовать значения по умолчанию. Дополнительные сведения см. в разделе «Примечания».

dwReserved2

Этот элемент зарезервирован и должен иметь значение 0.

Структура COSERVERINFO используется главным образом для идентификации удаленной системы в функциях создания объектов. Компьютерные ресурсы именуются по схеме именования сетевого транспорта. По умолчанию разрешены все имена UNC ("\\server" или "server") и DNS-имена ("домен.com", "example.microsoft.com" или "135.5.33.19").

Если параметр pAuthInfo имеет значение NULL, Snego будет использоваться для согласования службы проверки подлинности, которая будет работать между клиентом и сервером. Однако для pAuthInfo можно указать структуру COAUTHINFO, отличной от NULL, в соответствии с любой из следующих потребностей:

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

Если pAuthInfo не равно NULL, эти значения будут использоваться для указания параметров проверки подлинности для удаленного вызова. Эти параметры будут переданы в функцию RpcBindingSetAuthInfoEx .

Если параметр pAuthInfo имеет значение NULL, dwAuthnLevel можно переопределить с помощью уровня проверки подлинности, заданного функцией CoInitializeSecurity . Если функция CoInitializeSecurity не вызывается, используется уровень проверки подлинности, указанный в разделе реестра AppID , если он существует.

Начиная с Windows XP с пакетом обновления 2 (SP2), dwAuthnLevel — это максимум RPC_C_AUTHN_LEVEL_CONNECT и уровень проверки подлинности для всего процесса клиента, который выдает запрос на активацию. Для более ранних версий операционной системы это RPC_C_AUTHN_LEVEL_CONNECT.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Профессиональная [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows 2000 Server [классические приложения \| Приложения UWP]
Верхняя часть	objidl.h (включая Objidl.h)