RoGetServerActivatableClasses-Funktion (roregistrationapi.h)

Artikel
08/25/2023

Ruft die aktivierbaren Klassen ab, die für einen bestimmten ausführbaren Server (EXE) registriert sind, der unter der Paket-ID des aufrufenden Prozesses registriert wurde.

Syntax

HRESULT RoGetServerActivatableClasses(
  [in]  HSTRING serverName,
  [out] HSTRING **activatableClassIds,
  [out] DWORD   *count
);

Parameter

[in] serverName

Typ: HSTRING

Der Name des Servers, für den Klassenregistrierungen abgerufen werden sollen. Dieser Servername wird an die Befehlszeile übergeben, wenn der Server aktiviert wird.

[out] activatableClassIds

Typ: HSTRING**

Ein vom Anrufer zugewiesenes Array aktivierter Klassen-ID-Zeichenfolgen, für das der Server registriert ist. Die Zeichenfolgen müssen vom Aufrufer mithilfe der WindowsDeleteString-Funktion freigegeben werden. Der Puffer muss dann mit CoTaskMemFree freigegeben werden. Der Server (Aufrufer) ist für die Registrierung der Aktivierungsfabriken für diese Klassen verantwortlich.

[out] count

Typ: DWORD*

Die Anzahl der aktivierbaren Klassen-IDs, die im array activatableClassIds zurückgegeben werden.

Rückgabewert

Typ: HRESULT

Die Methode gibt bei Erfolg S_OK zurück, andernfalls einen Fehlercode, einschließlich des folgenden.

Rückgabecode	Beschreibung
REGDB_E_CLASSNOTREG	Es wird ein leerer Servername angegeben, der Server ist nicht registriert, oder es werden keine Klassen für diesen Server registriert.
E_ACCESSDENIED	Der Prozess verfügt nicht über ausreichende Berechtigungen zum Lesen der Registrierung dieses Servers.

Hinweise

Verwenden Sie die Funktion RoGetServerActivatableClasses , um die Klassennamen abzurufen, die vom Server erwartet werden. Rufen Sie die Details zu den einzelnen Klassen ab, indem Sie die RoGetActivatableClassRegistration-Funktion für jeden Klassennamen einzeln aufrufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	roregistrationapi.h
Bibliothek	Runtimeobject.lib

Freigeben über