Função RpcMgmtInqServerPrincNameW (rpcdce.h)

Artigo
11/20/2024

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

Sintaxe

RPC_STATUS RpcMgmtInqServerPrincNameW(
  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 principal para seu próprio aplicativo (local), especifique um valor de NULL.

AuthnSvc

Serviço de autenticação para o qual um nome principal é retornado. 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 no Binding. Se vários nomes forem registrados, apenas um nome será retornado.

Valor de retorno

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	Este foi o tipo errado de associação para a operação.

Observação Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.

Observações

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á.

Nota

O cabeçalho rpcdce.h define RpcMgmtInqServerPrincName como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [aplicativos da área de trabalho \| Aplicativos UWP]
servidor com suporte mínimo	Windows 2000 Server [aplicativos da área de trabalho \| Aplicativos UWP]
da Plataforma de Destino	Windows
cabeçalho	rpcdce.h (inclua Rpc.h)
biblioteca	Rpcrt4.lib
de DLL	Rpcrt4.dll

Consulte também

RpcStringFree

Compartilhar via