Metodo IXpsOMPage::GenerateUnusedLookupKey (xpsobjectmodel.h)

Articolo
12/22/2023

Genera un nome univoco che può essere usato come chiave di ricerca da una risorsa in un dizionario risorse.

Sintassi

HRESULT GenerateUnusedLookupKey(
  [in]          XPS_OBJECT_TYPE type,
  [out, retval] LPWSTR          *key
);

Parametri

[in] type

Tipo di oggetto IXpsOMShareable per il quale viene generata la chiave di ricerca.

[out, retval] key

Stringa di chiave di ricerca generata da questo metodo.

Valore restituito

Se il metodo ha esito positivo, restituisce S_OK; in caso contrario, restituisce un codice di errore HRESULT .

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_POINTER	la chiave è NULL.
E_INVALIDARG	il tipo fa riferimento a un tipo di oggetto non riconosciuto.

Commenti

Per essere univoci nel dizionario, la stringa generata da GenerateUnusedLookupKey è costituita da una stringa di prefisso basata sul tipo di oggetto ed è seguita da quattro caratteri alfanumerici univoci.

La stringa di prefisso per ogni tipo di oggetto viene visualizzata nella tabella seguente.

Tipo oggetto	Stringa di prefisso per questo tipo di oggetto
XPS_OBJECT_TYPE_CANVAS	Tela_
XPS_OBJECT_TYPE_GEOMETRY	Geometria_
XPS_OBJECT_TYPE_GLYPHS	Glifi_
XPS_OBJECT_TYPE_IMAGE_BRUSH	IBrush_
XPS_OBJECT_TYPE_LINEAR_GRADIENT_BRUSH	LGBrush_
XPS_OBJECT_TYPE_MATRIX_TRANSFORM	MTransform_
XPS_OBJECT_TYPE_PATH	Percorso_
XPS_OBJECT_TYPE_RADIAL_GRADIENT_BRUSH	RGBrush_
XPS_OBJECT_TYPE_SOLID_COLOR_BRUSH	SCBrush_
XPS_OBJECT_TYPE_VISUAL_BRUSH	VBrush_

Nota

Questo metodo restituisce una stringa chiave univoca nel contesto di questa pagina. Non è garantito restituire una chiave univoca in una risorsa del dizionario remoto che può essere usata da più pagine.

Questo metodo alloca la memoria usata dalla stringa restituita nella chiave. Se la chiave non è NULL, usare la funzione CoTaskMemFree per liberare la memoria.

Requisiti


Client minimo supportato	Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	xpsobjectmodel.h

Vedi anche

IXpsOMPage

XML Paper Specification

XPS_OBJECT_TYPE

Condividi tramite