Metodo IWSDXMLContext::AddNameToNamespace (wsdxml.h)

Articolo
03/13/2024

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

Sintassi

HRESULT AddNameToNamespace(
  [in]  LPCWSTR     pszUri,
  [in]  LPCWSTR     pszName,
  [out] WSDXML_NAME **ppName
);

Parametri

[in] pszUri

URI dello spazio dei nomi XML in cui verrà creato questo nome. Se questo spazio dei nomi non esiste già nel contesto XML, verrà generata automaticamente una nuova struttura dello spazio dei nomi.

[in] pszName

Nome da aggiungere allo spazio dei nomi specificato da pszUri.

[out] ppName

Struttura WSDXML_NAME per il nome appena creato. È necessario deallocare ppName chiamando WSDFreeLinkedMemory. Questo parametro è facoltativo e,

Valore restituito

I valori restituiti possibili includono, ma non sono limitati ai valori seguenti.

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

Commenti

È possibile utilizzare AddNameToNamespace durante la creazione di elementi XML per le sezioni estendibili. Le sezioni estendibili sono rappresentate da qualsiasi elemento in uno schema. La struttura restituita WSDXML_NAME a cui punta ppName può essere utilizzata per specificare il nome associato al contenuto dell'estensione. Quando si compila una struttura WSDXML_ELEMENT che rappresenta il contenuto dell'estensione, utilizzare la struttura WSDXML_NAME restituita per il membro Name dell'elemento.

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 (include Wsdapi.h)
DLL	Wsdapi.dll

Vedi anche

IWSDXMLContext

Condividi tramite