Função RpcMgmtInqServerPrincName (rpcdce.h)

  • Artigo

A função RpcMgmtInqServerPrincName retorna o nome principal de um servidor.

Sintaxe

RPC_STATUS RpcMgmtInqServerPrincName(
  RPC_BINDING_HANDLE Binding,
  unsigned long      AuthnSvc,
  RPC_WSTR           *ServerPrincName
);

Parâmetros

Binding

Para receber o nome principal de um servidor, especifique um identificador de associação de servidor para esse servidor. Para receber o nome da entidade de segurança para seu próprio aplicativo (local), especifique um valor NULL.

AuthnSvc

Serviço de autenticação para o qual um nome de entidade de segurança é retornado. Os valores válidos são a constante para qualquer provedor de segurança válido.

ServerPrincName

Retorna um nome principal registrado para o serviço de autenticação em AuthnSvc pelo servidor referenciado em Associação. Se vários nomes forem registrados, apenas um nome será retornado.

Valor retornado

Valor Significado
RPC_S_OK
 A chamada foi bem-sucedida.
RPC_S_INVALID_BINDING
 O identificador de associação era inválido.
RPC_S_WRONG_KIND_OF_BINDING
 Esse foi o tipo errado de associação para a operação.
 
Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.
 

Comentários

Um aplicativo chama a função RpcMgmtInqServerPrincName para obter o nome principal de um servidor registrado para um serviço de autenticação especificado.

A biblioteca de tempo de execução RPC aloca memória para a cadeia de caracteres retornada em ServerPrincName. O aplicativo é responsável por chamar a função RpcStringFree para liberar a memória usada por essa função.

O servidor deve estar escutando chamadas de procedimento remoto para que essa função tenha êxito. Se o servidor não estiver escutando, a função falhará.

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]
Plataforma de Destino Windows
Cabeçalho rpcdce.h (inclua Rpc.h)
Biblioteca Rpcrt4.lib
DLL Rpcrt4.dll

Confira também

RpcStringFree