Funzione RoRegisterActivationFactories (roapi.h)

Articolo
03/05/2024

Registra una matrice di factory di attivazione out-of-process per un server exe Windows Runtime.

Sintassi

HRESULT RoRegisterActivationFactories(
  [in]  HSTRING                 *activatableClassIds,
  [in]  PFNGETACTIVATIONFACTORY *activationFactoryCallbacks,
  [in]  UINT32                  count,
  [out] RO_REGISTRATION_COOKIE  *cookie
);

Parametri

[in] activatableClassIds

Tipo: HSTRING*

Matrice di identificatori di classe associati alle classi di runtime attivabili.

[in] activationFactoryCallbacks

Tipo: PFNGETACTIVATIONFACTORY*

Matrice di funzioni di callback che è possibile usare per recuperare le factory di attivazione corrispondenti ad activatableClassIds.

[in] count

Tipo: UINT32

Numero di elementi nelle matrici activatableClassIds e activationFactoryCallbacks .

[out] cookie

Tipo: RO_REGISTRATION_COOKIE*

Cookie che identifica le factory registrate.

Valore restituito

Tipo: HRESULT

Questa funzione può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	La factory di attivazione è stata registrata correttamente.
E_POINTER	cookie è NULL.
CO_E_NOT_SUPPORTED	Il thread si trova in un appartamento neutro.
CO_E_NOTINITIALIZED	Il thread non è stato inizializzato nella Windows Runtime chiamando la funzione RoInitialize.
CO_E_ALREADYINITIALIZED	La factory è già stata inizializzata.
REGDB_E_CLASSNOTREG	La classe non è registrata come OutOfProc.

Commenti

La funzione RoRegisterActivationFactories consente a un server exe di registrare più factory di attivazione senza riscontrare una race condition.

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	roapi.h
Libreria	RuntimeObject.lib
DLL	ComBase.dll

Vedi anche

RO_REGISTRATION_COOKIE

RoInitialize

Condividi tramite