Funzione RoGetServerActivatableClasses (roregistrationapi.h)

Articolo
03/01/2024

Recupera le classi attivabili registrate per un determinato server eseguibile (EXE), registrato con l'ID pacchetto del processo chiamante.

Sintassi

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

Parametri

[in] serverName

Tipo: HSTRING

Nome del server per cui recuperare le registrazioni della classe. Questo nome del server viene passato alla riga di comando quando il server viene attivato.

[out] activatableClassIds

Tipo: HSTRING**

Matrice allocata dal chiamato di stringhe ID classe attivabili da registrare nel server. Le stringhe devono essere rilasciate dal chiamante usando la funzione WindowsDeleteString . Il buffer deve quindi essere rilasciato usando CoTaskMemFree. Il server (chiamante) è responsabile della registrazione delle factory di attivazione per queste classi.

[out] count

Tipo: DWORD*

Conteggio degli ID di classe attivabili restituiti nella matrice activatableClassIds .

Valore restituito

Tipo: HRESULT

Il metodo restituisce S_OK in caso di esito positivo; in caso contrario, un codice di errore, incluso quanto segue.

Codice restituito	Descrizione
REGDB_E_CLASSNOTREG	Viene specificato un nome server vuoto, il server non è registrato o non viene registrata alcuna classe per questo server.
E_ACCESSDENIED	Il processo non dispone di autorizzazioni sufficienti per leggere la registrazione del server.

Commenti

Usare la funzione RoGetServerActivatableClasses per recuperare i nomi di classe che il server deve servire. Ottenere i dettagli sulle singole classi chiamando singolarmente la funzione RoGetActivatableClassRegistration in ogni nome di classe.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2012 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	roregistrationapi.h
Libreria	Runtimeobject.lib

Condividi tramite