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 |
|---|---|
|
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 |