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
Client minimo supportato | Windows XP [solo app desktop] |
Server minimo supportato | Windows Server 2003 [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | oleacc.h (include OleAcc.h Include Initguid.h first.) |
DLL | Oleacc.dll |
Componente ridistribuibile | Active Accessibility 2.0 RDK in Windows NT 4.0 con SP6 e versioni successive e Windows 98 |