Função DrtOpen (drt.h)
A função DrtOpen cria uma instância da Tabela de Roteamento Distribuído local em relação aos critérios especificados pela estrutura DRT_SETTINGS .
HRESULT DrtOpen(
[in] const DRT_SETTINGS *pSettings,
[in] HANDLE hEvent,
[in, optional] const PVOID pvContext,
[out] HDRT *phDrt
);
[in] pSettings
Ponteiro para a estrutura DRT_SETTINGS que especifica as configurações usadas para a criação da instância drt.
[in] hEvent
Identificador para o evento sinalizado quando ocorre um evento.
[in, optional] pvContext
Dados de contexto definidos pelo usuário que são passados para o aplicativo por meio de eventos.
[out] phDrt
O novo identificador associado ao DRT. Isso é usado em todas as operações futuras na instância drt.
Essa função retorna S_OK em caso de êxito. Outros valores possíveis incluem:
Código de retorno | Descrição |
---|---|
|
phDrt é NULL. |
|
pSettings é NULL ou o valor de membro dwSize de DRT_SETTINGS não é igual ao tamanho do objeto DRT_SETTINGS . |
|
cbKey não é igual a 256 bits. |
|
O membro ulMaxRoutingAddresses de DRT_SETTINGS especifica menos de 1 ou mais de 20 como o número máximo de endereços. |
|
O membro hTransport no DRT_SETTINGS é NULL ou alguns campos do Transporte são NULL |
|
O membro eSecurityMode do DRT_SETTINGS especifica um modo de segurança inválido. |
|
O membro pSecurityProvider do DRT_SETTINGS é NULL. |
|
O membro pBootstrapProvider do DRT_SETTINGS é NULL ou alguns campos do provedor de inicialização são NULL. |
|
O tamanho do pwzDrtInstancePrefix especificado em DRT_SETTINGS é maior que o comprimento máximo do prefixo (128). |
|
O sistema não pode alocar memória para esta operação. |
|
O provedor de inicialização já está anexado. |
|
O provedor de segurança já está anexado. |
|
O provedor de transporte já está anexado. |
|
A cadeia de certificação é inválida. |
|
O certificado local não pode ser NULL no DRT_SECURE_MEMBERSHIP e DRT_SECURE_CONFIDENTIALPAYLOAD segurança. |
|
O transporte está sendo desligado. |
|
O transporte já está associado. |
|
O provedor de inicialização não conseguiu localizar outros nós, mas pode ter êxito em uma segunda tentativa. |
|
O parâmetro do provedor de transporte é NULL ou inválido. |
|
O transporte não está anexado. |
|
Ocorreu um erro fatal inesperado. |
Depois que DrtOpen for chamado, o DRT iniciará o procedimento de inicialização e passará para o estado DRT_ACTIVE ou DRT_ALONE , dependendo do sucesso da inicialização.
Cliente mínimo com suporte | Windows 7 Professional [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows Server 2008 R2 [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | drt.h |
Biblioteca | Drt.lib |
DLL | Drt.dll |