Metodo IWSDXMLContext::AddNamespace (wsdxml.h)

Articolo
08/28/2023

Crea un oggetto che rappresenta uno spazio dei nomi in un contesto XML. Se lo spazio dei nomi esiste già, non verrà aggiunto alcun nuovo spazio dei nomi e verrà restituito l'oggetto spazio dei nomi per il nome esistente.

Sintassi

HRESULT AddNamespace(
  [in]  LPCWSTR          pszUri,
  [in]  LPCWSTR          pszSuggestedPrefix,
  [out] WSDXML_NAMESPACE **ppNamespace
);

Parametri

[in] pszUri

URI dello spazio dei nomi.

[in] pszSuggestedPrefix

Prefisso dello spazio dei nomi da usare durante la generazione di XML. Se lo spazio dei nomi esiste già, pszSuggestPrefix sovrascriverà il prefisso attualmente associato allo spazio dei nomi. Il contesto XML può assegnare un prefisso dello spazio dei nomi diverso. Il prefisso assegnato dal contesto XML ha la precedenza sul prefisso suggerito. Il membro PreferredPrefix della struttura a cui fa riferimento ppNamespace contiene il prefisso assegnato dal contesto XML.

[out] ppNamespace

Puntatore all'indirizzo della struttura WSDXML_NAMESPACE che rappresenta lo spazio dei nomi. È necessario deallocare ppNamespace chiamando WSDFreeLinkedMemory. Questo parametro è facoltativo e,

Valore restituito

I valori restituiti possibili includono, ma non sono limitati a, quanto segue.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_INVALIDARG	pszUri è NULL, la lunghezza in caratteri della stringa URI supera WSD_MAX_TEXT_LENGTH (8192), pszSuggestPrefix è NULL o la lunghezza in caratteri della stringa di prefisso supera WSD_MAX_TEXT_LENGTH (8192).
E_OUTOFMEMORY	Memoria insufficiente per completare l'operazione.
E_FAIL	Il metodo non è riuscito.

Commenti

La struttura restituita WSDXML_NAMESPACE può essere usata per forzare un'associazione tra il prefisso dello spazio dei nomi (come specificato da pszSuggestPrefix) e l'URI dello spazio dei nomi (come specificato da pszUri). Dopo aver stabilito questa associazione, il generatore XML produrrà XML con il prefisso dello spazio dei nomi specificato.

È possibile chiamare AddNamespace per recuperare la struttura WSDXML_NAMESPACE creata quando uno spazio dei nomi è stato generato automaticamente da una chiamata a AddNameToNamespace.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wsdxml.h (includere Wsdapi.h)
DLL	Wsdapi.dll

Vedi anche

IWSDXMLContext

Condividi tramite