RoGetServerActivatableClasses-Funktion (roregistrationapi.h)

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.

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