WsGetPrefixFromNamespace-Funktion (webservices.h)

Artikel
03/03/2024

Diese Funktion gibt das Präfix zurück, an das ein Namespace gebunden ist. Es kann mehrere Präfixe im Bereich geben, und diese Funktion kann eines davon zurückgeben.

Hinweis Unter keinen Umständen sollte ein Aufrufer davon abhängen oder erwarten, dass ein bestimmtes Präfix zurückgegeben wird, wenn mehrere Präfixe zurückgegeben werden.

Wenn der Wert des erforderlichen Parameters auf TRUE festgelegt ist und der Namespace nicht an ein Präfix gebunden ist, wird eine WS_E_INVALID_FORMAT Ausnahme zurückgegeben. (Siehe Rückgabewerte für Windows-Webdienste.) Wenn der erforderliche Parameter FALSE ist und der Namespace nicht an ein Präfix gebunden ist, ist der PräfixparameterNULL , und die Funktion gibt S_FALSE zurück.

Wenn WsWriteStartElement aufgerufen wird, das -Element aber nicht committet wird, sind die Namespaces und Präfixe, auf die das Element verweist, und alle Attribute für das Element sind für diese Funktion nicht verfügbar.

Syntax

HRESULT WsGetPrefixFromNamespace(
  [in]           WS_XML_WRITER       *writer,
  [in]           const WS_XML_STRING *ns,
  [in]           BOOL                required,
                 const WS_XML_STRING **prefix,
  [in, optional] WS_ERROR            *error
);

Parameter

[in] writer

Ein Zeiger auf einen Writer mit dem zu durchsuchenden Namespace. Dies muss ein gültiges WS_XML_WRITER-Objekt sein, das von WsCreateWriter zurückgegeben wird und möglicherweise nicht NULL ist.

[in] ns

Der zu suchende Namespace.

[in] required

Gibt an, ob ein Fehler zurückgegeben werden soll, wenn kein übereinstimmende Präfix gefunden wird.

prefix

Ein Verweis auf ein Präfix, das an den Namespace oder NULL gebunden ist, wenn der Wert des erforderlichen Parameters FALSE ist und kein übereinstimmenden Namespace gefunden wird.

Hinweis Der zurückgegebene Wert ist nur gültig, bis der Writer voranschreitet.

[in, optional] error

Ein Zeiger auf ein WS_ERROR-Objekt , in dem zusätzliche Informationen zum Fehler gespeichert werden sollen, wenn die Funktion fehlschlägt.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode	Beschreibung
WS_E_INVALID_FORMAT	Die Eingabedaten waren nicht im erwarteten Format oder hatten nicht den erwarteten Wert.

Hinweise

Für den Namespace "http://www.w3.org/XML/1998/namespace" Das Präfix "xml" wird zurückgegeben.

Für den Namespace "http://www.w3.org/2000/xmlns/" Das Präfix "xmlns" wird zurückgegeben.

Das zurückgegebene Präfix sollte nicht geändert werden und ist nur gültig, bis der Writer voranschreitet.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	webservices.h
Bibliothek	WebServices.lib
DLL	WebServices.dll

Freigeben über