Funzione QueryActCtxW (winbase.h)

La funzione QueryActCtxW esegue una query sul contesto di attivazione.

Sintassi

BOOL QueryActCtxW(
  [in]            DWORD  dwFlags,
  [in]            HANDLE hActCtx,
  [in, optional]  PVOID  pvSubInstance,
  [in]            ULONG  ulInfoClass,
  [out]           PVOID  pvBuffer,
  [in, optional]  SIZE_T cbBuffer,
  [out, optional] SIZE_T *pcbWrittenOrRequired
);

Parametri

[in] dwFlags

Questo parametro deve essere impostato su uno dei bit di flag seguenti.

[in] hActCtx

Gestire il contesto di attivazione sottoposto a query.

[in, optional] pvSubInstance

Indice dell'assembly o dell'assembly e della combinazione di file nel contesto di attivazione. Il significato del valore pvSubInstance dipende dall'opzione specificata dal valore del parametro ulInfoClass .

Questo parametro può essere null.

[in] ulInfoClass

Questo parametro può avere solo i valori visualizzati nella tabella seguente.

[out] pvBuffer

Puntatore a un buffer che contiene le informazioni restituite. Questo parametro è facoltativo e, Se pvBuffer è Null, cbBuffer deve essere zero. Se le dimensioni del buffer puntate da pvBuffer sono troppo piccole, QueryActCtxW restituisce ERROR_INSUFFICIENT_BUFFER e non vengono scritti dati nel buffer. Vedere la sezione Osservazioni per il metodo che è possibile usare per determinare le dimensioni necessarie del buffer.

[in, optional] cbBuffer

Dimensioni del buffer in byte puntate da pvBuffer. Questo parametro è facoltativo e,

[out, optional] pcbWrittenOrRequired

Numero di byte scritti o obbligatori. Il parametro pcbWrittenOrRequired può essere NULL solo quando pvBuffer è NULL. Se pcbWrittenOrRequired non è NULL, viene riempito con il numero di byte necessari per archiviare il buffer restituito.

Valore restituito

Se la funzione ha esito positivo, restituisce TRUE. In caso contrario, restituisce FALSE.

Questa funzione imposta errori che possono essere recuperati chiamando GetLastError. Per un esempio, vedere Recupero del codice Last-Error. Per un elenco completo dei codici di errore, vedere Codici di errore di sistema.

Commenti

Il parametro cbBuffer specifica le dimensioni in byte del buffer a cui punta pvBuffer. Se pvBuffer è NULL, cbBuffer deve essere 0. Il parametro pcbWrittenOrRequired può essere NULL solo se pvBuffer è NULL. Se pcbWrittenOrRequired è non NULL in caso di restituzione, viene riempito con il numero di byte necessari per archiviare le informazioni restituite. Quando i dati delle informazioni restituiti sono maggiori del buffer fornito, QueryActCtxW restituisce ERROR_INSUFFICIENT_BUFFER e non vengono scritti dati nel buffer a cui punta pvBuffer.

Nell'esempio seguente viene illustrato il metodo di chiamata prima con un buffer di piccole dimensioni e quindi viene richiamato se il buffer è troppo piccolo.

SIZE_T cbRequired;
PVOID pvData = NULL;
SIZE_T cbAvailable = 0;

if (!QueryActCtxW(..., pvData, cbAvailable, &cbRequired) && (GetLastError()== ERROR_INSUFFICIENT_BUFFER))
{
    // Allocate enough space to store the returned buffer, fail if too small
    if (NULL == (pvData = HeapAlloc(GetProcessHeap(), 0, cbRequired)))
    {
        SetLastError(ERROR_NOT_ENOUGH_MEMORY);
        return FALSE;
    }
    cbAvailable = cbRequired;
    // Try again, this should succeed.
    if (QueryActCtxW(..., pvData, cbAvailable, &cbRequired))
    {
        // Use the returned data in pvData
    }
    HeapFree(GetProcessHeap(), 0, pvData);
    pvData = NULL;
}

Requisiti