Função NtOpenEnlistment (wdm.h)
A rotina ZwOpenEnlistment obtém um identificador para um objeto de inscrição existente.
__kernel_entry NTSYSCALLAPI NTSTATUS NtOpenEnlistment(
[out] PHANDLE EnlistmentHandle,
[in] ACCESS_MASK DesiredAccess,
[in] HANDLE ResourceManagerHandle,
[in] LPGUID EnlistmentGuid,
[in, optional] POBJECT_ATTRIBUTES ObjectAttributes
);
[out] EnlistmentHandle
Um ponteiro para uma variável alocada por chamador que recebe um identificador para um objeto de inscrição se a chamada para ZwOpenEnlistment for bem-sucedida.
[in] DesiredAccess
Um valor ACCESS_MASKdigitado que especifica o acesso solicitado ao objeto de inscrição. Para obter mais informações sobre como especificar esse parâmetro, consulte o parâmetro DesiredAccess de ZwCreateEnlistment. Esse parâmetro não pode ser zero.
[in] ResourceManagerHandle
Um identificador para um objeto do gerenciador de recursos obtido por uma chamada anterior para ZwCreateResourceManager ou ZwOpenResourceManager.
[in] EnlistmentGuid
Um ponteiro para um GUID que identifica a inscrição. Para obter mais informações, consulte a seção Comentários a seguir.
[in, optional] ObjectAttributes
Um ponteiro para uma estrutura OBJECT_ATTRIBUTES que especifica os atributos do objeto. Use a rotina InitializeObjectAttributes para inicializar essa estrutura, mas especifique apenas os parâmetros InitializedAttributes e Attributes da rotina. Se o chamador não estiver em execução em um contexto de thread do sistema, ele deverá definir o sinalizador OBJ_KERNEL_HANDLE no parâmetro atributos. Esse parâmetro é opcional e pode ser NULL.
ZwOpenEnlistment retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, essa rotina poderá retornar um dos seguintes valores:
| Código de retorno | Descrição |
|---|---|
|
O identificador de objeto é inválido. |
|
O chamador não tem acesso apropriado ao objeto de inscrição. |
|
O valor do parâmetro DesiredAccess é zero ou o valor do parâmetro EnlistmentGuid é NULL. |
|
A inscrição especificada pelo parâmetro EnlistmentGuid não existe para o gerenciador de recursos especificado pelo parâmetro RmHandle . |
|
O valor do parâmetro DesiredAccess é inválido. |
A rotina pode retornar outros valores NTSTATUS .
Normalmente, um componente TPS chama ZwOpenEnlistment depois de receber um GUID de inscrição de outro componente TPS que anteriormente havia chamado ZwCreateEnlistment. A maioria dos designs TPS não exige chamar ZwOpenEnlistment .
Um gerenciador de recursos que chama ZwOpenEnlistment deve eventualmente chamar ZwClose para fechar o identificador de objeto.
Para obter mais informações sobre ZwOpenEnlistment, consulte Objetos de Inscrição.
NtOpenEnlistment e ZwOpenEnlistment são duas versões da mesma rotina dos Serviços do Sistema Nativo do Windows.
Para chamadas de drivers no modo kernel, as versões NtXxx e Zwxxx versões de uma rotina dos Serviços de Sistema Nativo do Windows podem se comportar de forma diferente na maneira como lidam e interpretam parâmetros de entrada. Para obter mais informações sobre a relação entre as versões NtXxx e ZwXxx de uma rotina, consulte Usando versões Nt e Zw das rotinas de serviços do sistema nativo.
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows Vista e versões posteriores do sistema operacional. |
| da Plataforma de Destino | Universal |
| cabeçalho | wdm.h (include Wdm.h, Ntifs.h) |
| biblioteca | NtosKrnl.lib |
| de DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| regras de conformidade de DDI | HwStorPortProhibitedDIs, PowerIrpDDis |
usando versões Nt e Zw das rotinas de serviços do sistema nativo