SetResourceManagerCompletionPort-Funktion (ktmw32.h)

  • Artikel

Ordnet den angegebenen E/A-Vervollständigungsport dem angegebenen Ressourcen-Manager (RM) zu. Dieser Port empfängt alle Benachrichtigungen für den RM.

Syntax

BOOL SetResourceManagerCompletionPort(
  [in] HANDLE    ResourceManagerHandle,
  [in] HANDLE    IoCompletionPortHandle,
  [in] ULONG_PTR CompletionKey
);

Parameter

[in] ResourceManagerHandle

Ein Handle für den Ressourcen-Manager.

[in] IoCompletionPortHandle

Ein Handle für den E/A-Vervollständigungsport.

[in] CompletionKey

Der benutzerdefinierte Bezeichner. In der Regel wird sie verwendet, um die Empfangsbenachrichtigung einem bestimmten Ressourcen-Manager zuzuordnen.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert 0 (null). Um erweiterte Fehlerinformationen zu erhalten, rufen Sie die Funktion GetLastError auf.

In der folgenden Liste werden die möglichen Fehlercodes identifiziert:

Hinweise

Diese Funktion muss in Verbindung mit der GetNotificationResourceManagerAsync-Funktion verwendet werden, die die Puffer bereitstellt, die KTM zum asynchronen Senden von Benachrichtigungen verwendet. Diese Funktionen bieten eine andere Möglichkeit, Benachrichtigungen von KTM zu empfangen. Sie können diese beiden Funktionen anstelle der GetNotificationResourceManager-Funktion verwenden.

Diese Funktion muss aufgerufen werden, bevor GetNotificationResourceManagerAsync aufgerufen wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile ktmw32.h
Bibliothek Ktmw32.lib
DLL Ktmw32.dll

Weitere Informationen

GetNotificationResourceManager

GetNotificationResourceManagerAsync

Kerneltransaktions-Manager-Funktionen