WsGetNamespaceFromPrefix-Funktion (webservices.h)

Diese Funktion gibt einen Namespace aus dem Präfix zurück, an das sie gebunden ist.

Wenn der Wert des erforderlichen Parameters auf TRUE festgelegt ist und das Präfix nicht an einen Namespace 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 das Präfix an keinen Namespace gebunden ist, ist der ns-ParameterNULL , und die Funktion gibt S_FALSE zurück.

Syntax

HRESULT WsGetNamespaceFromPrefix(
  [in]           WS_XML_READER       *reader,
  [in]           const WS_XML_STRING *prefix,
  [in]           BOOL                required,
                 const WS_XML_STRING **ns,
  [in, optional] WS_ERROR            *error
);

Parameter

[in] reader

Ein Zeiger auf den Leser, nach dem das Präfix gesucht werden soll.

[in] prefix

Ein Zeiger auf das Präfix, nach dem gesucht werden soll.

[in] required

Der Wert dieses booleschen Parameters bestimmt, ob ein Fehler zurückgegeben werden soll, wenn kein übereinstimmenden Namespace gefunden wird.

ns

Ein Verweis auf einen Namespace, an den das Präfix bei erfolgreicher Ausführung gebunden ist. 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.

Hinweise

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

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

Anforderungen