Metodo IAccPropServices::SetPropServer (oleacc.h)

I server usano SetPropServer per specificare un oggetto callback da utilizzare per annotare una matrice di proprietà per l'elemento accessibile. È anche possibile specificare se l'annotazione deve essere applicata a questo elemento accessibile o all'elemento e ai relativi elementi figlio. Questo metodo viene usato per l'annotazione del server.

Se gli sviluppatori di server conoscono il valore HWND dell'elemento accessibile da annotare, possono usare IAccPropServices::SetHwndPropServer.

Sintassi

HRESULT SetPropServer(
  [in] const BYTE       *pIDString,
  [in] DWORD            dwIDStringLen,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps,
  [in] IAccPropServer   *pServer,
  [in] AnnoScope        annoScope
);

Parametri

[in] pIDString

Tipo: const BYTE*

Identifica l'elemento accessibile da annotare.

[in] dwIDStringLen

Tipo: DWORD

Specifica la lunghezza della stringa identificata dal parametro pIDString.

[in] paProps

Tipo: const MSAAPROPID*

Specifica una matrice di proprietà che dovrà essere gestita dall'oggetto callback specificato.

[in] cProps

Tipo: int

Specifica una matrice di proprietà che dovrà essere gestita dall'oggetto callback specificato.

[in] pServer

Tipo: IAccPropServer*

Specifica l'oggetto callback che verrà richiamato quando un client richiede una delle proprietà sottoposte a override.

[in] annoScope

Tipo: AnnoScope

Può essere ANNO_THIS, che indica che l'annotazione influisce solo sull'elemento accessibile indicato, oppure ANNO_CONTAINER, che indica che l'annotazione si applica all'elemento e ai relativi elementi figlio diretti.

Valore restituito

Tipo: HRESULT

Se ha esito positivo, restituisce S_OK.

Restituisce E_INVALIDARG se una delle proprietà nella matrice paProps non è supportata, se la stringa identity non è valida o se annoScope non è uno dei ANNO_THIS o ANNO_CONTAINER.

Può restituire altri codici di errore in condizioni di errore eccezionali, ad esempio memoria insufficiente.

Commenti

Per un elenco delle proprietà supportate e dei relativi tipi previsti, vedere la sezione relativa al supporto.

Il tempo di esecuzione dell'annotazione userà AddRef per incrementare il contatore di riferimento per l'oggetto callback pServer in modo appropriato. Il chiamante è libero di rilasciarlo dopo aver chiamato questo metodo. Il tempo di esecuzione dell'annotazione rilascia automaticamente l'oggetto callback dopo che l'elemento accessibile da annotare non viene più utilizzato.

Requisiti