Função GetNotificationResourceManager (ktmw32.h)

Artigo
08/24/2023

Solicita e recebe uma notificação para um gerenciador de recursos (RM). Essa função é usada pelo registro RM para receber notificações quando uma transação altera o estado.

Sintaxe

BOOL GetNotificationResourceManager(
  [in]            HANDLE                    ResourceManagerHandle,
  [out]           PTRANSACTION_NOTIFICATION TransactionNotification,
  [in]            ULONG                     NotificationLength,
  [in, optional]  DWORD                     dwMilliseconds,
  [out, optional] PULONG                    ReturnLength
);

Parâmetros

[in] ResourceManagerHandle

Um identificador para o gerenciador de recursos.

[out] TransactionNotification

Um ponteiro para uma estrutura TRANSACTION_NOTIFICATION que recebe a primeira notificação disponível.

[in] NotificationLength

O tamanho do buffer TransactionNotification , em bytes.

[in, optional] dwMilliseconds

O tempo, em milissegundos, para o qual o aplicativo de chamada está bloqueando enquanto aguarda a notificação ficar disponível. Se nenhuma notificação estiver disponível quando o tempo limite expirar, ERROR_TIMEOUT será retornado.

[out, optional] ReturnLength

Um ponteiro para uma variável que recebe o tamanho real da notificação recebida pelo parâmetro TransactionNotification .

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será 0 (zero). Para obter informações de erro estendidas, chame a função GetLastError.

A lista a seguir identifica os possíveis códigos de erro:

Comentários

Todos os gerenciadores de recursos devem se registrar para receber notificações de TRANSACTION_NOTIFY_PREPREPARE, TRANSACTION_NOTIFY_PREPARE e TRANSACTION_NOTIFY_COMMIT , mesmo que posteriormente chamem ReadOnlyEnlistment para marcar um alistamento como somente leitura. Os gerenciadores de recursos podem dar suporte a TRANSACTION_NOTIFY_SINGLE_PHASE_COMMIT, mas também devem dar suporte às notificações de pré-preparação, preparação e confirmação de várias fases. Para obter a lista de todas as notificações que os gerenciadores de recursos podem receber, consulte TRANSACTION_NOTIFICATION.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	ktmw32.h
Biblioteca	KtmW32.lib
DLL	KtmW32.dll