CreateResourceManager-Funktion (ktmw32.h)
Erstellt ein neues Ressourcen-Manager -Objekt (RM) und ordnet die 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 der GUID des Ressourcen-Managers. Dieser Parameter ist erforderlich und darf nicht NULL-sein.
[in, optional] CreateOptions
Alle optionalen Attribute für den neuen RM.
| Wert | Bedeutung |
|---|---|
|
Gibt an, dass der RM veränderlich ist und keine Wiederherstellung durchführt. |
[in] TmHandle
Ein Handle für die TM, die 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, wird der Rückgabewert INVALID_HANDLE_VALUE. Rufen Sie zum Abrufen erweiterter Fehlerinformationen die GetLastError--Funktion auf.
Die folgende Liste identifiziert die möglichen Fehlercodes:
Bemerkungen
Unmittelbar nach dem Aufrufen dieser Funktion müssen Sie RecoverResourceManageraufrufen.
Ein RM ist ein Endpunkt für TM-Benachrichtigungen in Bezug auf Transaktionen, in denen der RM eingetragen wurde.
RMs sind in der Regel persistent, was bedeutet, dass sie nach einem Systemausfall erneut geöffnet werden müssen, um bestimmte Vorgänge auszuführen. Veränderliche oder vorübergehende RMs können erstellt werden, indem sie die CreateResourceManager--Funktion aufrufen und RESOURCE_MANAGER_VOLATILE angeben. Veränderliche RMs führen keine Wiederherstellungsvorgänge aus, erfordern jedoch Benachrichtigungen zu einer Transaktion.
Sie können eine veränderliche RM auf einer dauerhaften TM erstellen, aber Sie können keinen dauerhaften RM für eine veränderliche TM erstellen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| mindestens unterstützte Server- | Windows Server 2008 |
| Zielplattform- | Fenster |
| Header- | ktmw32.h |
| Library | Ktmw32.lib |
| DLL- | Ktmw32.dll |