CreateResourceManager-Funktion (ktmw32.h)

Erstellt ein neues Ressourcen-Manager-Objekt (RM) und ordnet das RM einem Transaktions-Manager (TM) zu.

Syntax

HANDLE CreateResourceManager(
  [in, optional] LPSECURITY_ATTRIBUTES lpResourceManagerAttributes,
  [in]           LPGUID                ResourceManagerId,
  [in, optional] DWORD                 CreateOptions,
  [in]           HANDLE                TmHandle,
  [in, optional] LPWSTR                Description
);

Parameter

[in, optional] lpResourceManagerAttributes

Ein Zeiger auf eine SECURITY_ATTRIBUTES-Struktur , die die Sicherheitsattribute für den Ressourcen-Manager enthält. Geben Sie NULL an, um die Standardattribute abzurufen.

[in] ResourceManagerId

Ein Zeiger auf die Ressourcen-Manager-GUID. Dieser Parameter ist erforderlich und darf nicht NULL sein.

[in, optional] CreateOptions

Alle optionalen Attribute für die neue RM.

Wert	Bedeutung
RESOURCE_MANAGER_VOLATILE	Gibt an, dass die RM volatil ist und keine Wiederherstellung ausführt.

[in] TmHandle

Ein Handle für das TM, das die Transaktionen für diesen RM verwaltet.

[in, optional] Description

Eine Beschreibung für diesen RM.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für den RM.

Wenn die Funktion fehlschlägt, ist der Rückgabewert INVALID_HANDLE_VALUE. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie die GetLastError-Funktion auf.

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

Hinweise

Unmittelbar nach dem Aufrufen dieser Funktion müssen Sie RecoverResourceManager aufrufen.

Ein RM ist ein Endpunkt für TM-Benachrichtigungen zu Transaktionen, bei denen sich der RM angemeldet hat.

RMs sind in der Regel persistent, was bedeutet, dass sie nach einem Systemfehler erneut geöffnet werden müssen, um bestimmte Vorgänge auszuführen. Flüchtige oder vorübergehende RMs können erstellt werden, indem die CreateResourceManager-Funktion aufgerufen und RESOURCE_MANAGER_VOLATILE angegeben wird. Flüchtige RMs führen keine Wiederherstellungsvorgänge aus, erfordern jedoch Benachrichtigungen zu einer Transaktion.

Sie können einen flüchtigen RM auf einem dauerhaften TM erstellen, aber sie können keinen dauerhaften RM auf einem flüchtigen TM erstellen.

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

Kerneltransaktions-Manager-Funktionen

OpenResourceManager

SECURITY_ATTRIBUTES

SetResourceManagerCompletionPort