funzione wiasParseEndorserString (wiamdef.h)
La funzione wiasParseEndorserString analizza una stringa di approvazione, sostituendo i token definiti dal servizio WIA e definiti dal fornitore nella stringa con valori associati a tali token.
Sintassi
HRESULT wiasParseEndorserString(
[in] BYTE *pWiasContext,
LONG lFlags,
[out, optional] WIAS_ENDORSER_INFO *pInfo,
[out] BSTR *pOutputString
);
Parametri
[in] pWiasContext
Puntatore a un contesto di elemento WIA (contesto dell'elemento contenente la proprietà WIA_DPS_ENDORSER_STRING (descritta nella documentazione di Microsoft Windows SDK).
lFlags
Riservato per l'uso del sistema e deve essere impostato su 0.
[out, optional] pInfo
Puntatore a una struttura WIAS_ENDORSER_INFO contenente il conteggio delle pagine e un elenco di coppie token/valore personalizzate. Può essere NULL.
[out] pOutputString
Puntatore a una posizione di memoria che riceve l'indirizzo della stringa di approvazione analizzata. Se *pOutputString è non NULL nella voce, la funzione presuppone che il chiamante allocato il buffer; in caso contrario, il servizio WIA lo allocherà. Si noti che il servizio WIA presuppone che la stringa di approvazione risultante massima sia MAX_PATH (definita in stdlib.h) caratteri lunghi. Se il driver prevede che la stringa sia più lunga, deve allocare il buffer stesso. Se il chiamante alloca il buffer, deve inizializzare il contenuto del buffer su zero prima di usare questa funzione.
Valore restituito
In caso di esito positivo, la funzione restituisce S_OK.
Se la funzione ha esito negativo, restituisce un errore COM standard o uno dei codici di errore WIA.
Commenti
Un'applicazione imposta la proprietà WIA_DPS_ENDORSER_STRING su una stringa che può contenere i token definiti dal servizio WIA $DATE$, $TIME$, $PAGE_COUNT$, $DAY$, $MONTH$e $YEAR$, nonché token definiti dal fornitore. Dopo che un driver chiama wiasParseEndorserString, la stringa puntata da pOutputString contiene una copia della stringa in WIA_DPS_ENDORSER_STRING proprietà, ma con qualsiasi token sostituito dai valori rappresentati dai token. Ad esempio, se l'applicazione imposta la stringa di approvazione su "Questa pagina è stata analizzata in $DATE$" e la data corrente è stata il 1° ottobre 2000, la stringa di output risultante sarà "Questa pagina è stata analizzata nel 2000/10/1".
L'elenco dei token di approvazione WIA standard è disponibile in wiadef.h.
I driver possono richiedere che i valori di sostituzione wiasParseEndorserString per i token definiti dal fornitore compilano una struttura WIAS_ENDORSER_VALUE per ogni coppia token/valore e la creazione di tutte queste strutture in una struttura WIAS_ENDORSER_INFO . Nell'esempio seguente viene illustrato come usare questa funzione.
HRESULT hr = S_OK;
BSTR bstrResultingEndorser = NULL;
WIAS_ENDORSER_VALUE aMyTokens[] = {L"$MY_TOKEN$", L"My value"};
WIAS_ENDORSER_INFO Info = {0, 1, aMyTokens};
hr = wiasParseEndorserString(pWiasContext, 0,
&Info, &bstrResultingEndorser);
Supponendo che la proprietà WIA_DPS_ENDORSER_STRING contenga "This is $MY_TOKEN$" e che la chiamata a wiasParseEndorserString ha avuto esito positivo, bstrResultingEndorser conterrà ora "This is My value".
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | wiamdef.h (include Wiamdef.h) |
| Libreria | Wiaservc.lib |
| DLL | Wiaservc.dll |