Compartilhar via

Função RpcServerInqDefaultPrincName (rpcdce.h)

  • Artigo

A função RpcServerInqDefaultPrincName obtém o nome da entidade de segurança padrão para um determinado serviço de autenticação.

Sintaxe

RPC_STATUS RpcServerInqDefaultPrincName(
  unsigned long AuthnSvc,
  RPC_WSTR      *PrincName
);

Parâmetros

AuthnSvc

Serviço de autenticação a ser usado quando o servidor recebe uma solicitação para uma chamada de procedimento remoto.

PrincName

Após o êxito, contém o nome da entidade de segurança padrão para o serviço de autenticação especificado pelo parâmetro AuthnSvc . O serviço de autenticação em uso define o conteúdo do nome e sua sintaxe. Esse nome principal deve ser usado como o parâmetro ServerPrincName da função RpcServerRegisterAuthInfo . Se a função for bem-sucedida, PrincName deverá ser liberado usando a função RpcStringFree . Se a função falhar, o conteúdo de PrincName será indefinido e o chamador não terá obrigação de liberá-lo.

Valor retornado

Valor Significado
RPC_S_OK
 A chamada foi bem-sucedida.
RPC_S_OUT_OF_MEMORY
 Não há memória suficiente para concluir a operação.
 
Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.
 

Comentários

Essa função é a maneira recomendada de obter o nome da entidade de segurança do servidor a ser passado para a função RpcServerRegisterAuthInfo . Embora a composição do nome da entidade de segurança do servidor seja possível sem usar essa função, chamar a função é mais fácil e portátil entre as versões do sistema operacional.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho rpcdce.h (inclua Rpc.h)
Biblioteca Rpcrt4.lib
DLL Rpcrt4.dll

Confira também

RpcBindingSetAuthInfo

RpcServerRegisterAuthInfo