Estrutura COSERVERINFO (objidl.h)

Artigo
08/25/2023

Identifica um recurso de computador remoto para as funções de ativação.

Sintaxe

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

Membros

dwReserved1

Esse membro é reservado e deve ser 0.

pwszName

O nome do computador.

pAuthInfo

Um ponteiro para uma estrutura COAUTHINFO para substituir a segurança de ativação padrão para ativações remotas do computador. Caso contrário, defina como NULL para indicar que os valores padrão devem ser usados. Para obter mais informações, consulte a seção Comentários.

dwReserved2

Esse membro é reservado e deve ser 0.

Comentários

A estrutura COSERVERINFO é usada principalmente para identificar um sistema remoto em funções de criação de objeto. Os recursos de computador são nomeados usando o esquema de nomenclatura do transporte de rede. Por padrão, todos os nomes UNC ("\server" ou "server") e DNS ("domain.com", "example.microsoft.com" ou "135.5.33.19") são permitidos.

Se pAuthInfo estiver definido como NULL, o Snego será usado para negociar um serviço de autenticação que funcionará entre o cliente e o servidor. No entanto, uma estrutura COAUTHINFO não NULL pode ser especificada para pAuthInfo atender a qualquer uma das seguintes necessidades:

Para especificar uma identidade de cliente diferente para ativações remotas do computador. A identidade especificada será usada para a permissão de inicialização marcar no servidor em vez da identidade real do cliente.
Para especificar que Kerberos, em vez de NTLMSSP, é usado para ativação remota do computador. Uma identidade de cliente não padrão pode ou não ser especificada.
Para solicitar a ativação não seguro.
Para especificar um serviço de autenticação proprietário.

Se pAuthInfo não for NULL, esses valores serão usados para especificar as configurações de autenticação para a chamada remota. Essas configurações serão passadas para a função RpcBindingSetAuthInfoEx .

Se o parâmetro pAuthInfo for NULL, dwAuthnLevel poderá ser substituído pelo nível de autenticação definido pela função CoInitializeSecurity . Se a função CoInitializeSecurity não for chamada, o nível de autenticação especificado na chave do Registro appID será usado, se existir.

A partir do Windows XP com o Service Pack 2 (SP2), dwAuthnLevel é o máximo de RPC_C_AUTHN_LEVEL_CONNECT e o nível de autenticação em todo o processo do processo de cliente que está emitindo a solicitação de ativação. Para versões anteriores do sistema operacional, isso é RPC_C_AUTHN_LEVEL_CONNECT.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows 2000 Server [aplicativos da área de trabalho \| Aplicativos UWP]
Cabeçalho	objidl.h (inclua Objidl.h)