SLPParseSrvURL Unterroutine
Zweck
Analysiert die als Argument übergebene URL in eine Service- URL -Struktur und gibt sie im ppSrvURL zeiger zurück.
Syntax
SLPError SLPParseSrvURL(char *pcSrvURL
SLPSrvURL** ppSrvURL);
Beschreibung
Das SLPParseSrvURL unterprogramm analysiert die als Argument übergebene URL in eine Service- URL -Struktur und gibt sie im ppSrvURL zeiger zurück. Wenn ein Parsing-Fehler auftritt, wird SLP_PARSE_ERRORzurückgegeben. Der Eingabepuffer pcSrvURL wird während des Parsens destruktiv verändert und zum Ausfüllen der Felder der Rückgabestruktur verwendet. Die zurückgegebene Struktur ppSrvURL zurückgegebene Struktur sollte mit SLPFreeURL( freigegeben werden. Wenn URL keinen Serviceteil hat, ist die s_pcSrvPart zeichenfolge ist die leere Zeichenfolge ( "" ), nicht NULL. Wenn pcSrvURL nicht service: URL ist, dann ist das s_pcSrvType feld in der zurückgegebenen Datenstruktur das Schema von URL ist, das möglicherweise nicht mit dem Diensttyp übereinstimmt, unter dem URL registriert wurde. Wenn es sich bei dem Transport um IP handelt, ist das s_pcTransport feld leer. Wenn der Transport nicht IP ist oder keine Portnummer vorhanden ist, ist das s_iPort ist das Feld 0.
Parameter
| Element | Beschreibung |
|---|---|
| pcSrvURL | Ein Zeiger auf einen Zeichenpuffer, der die zu analysierende nullterminierte URL -Zeichenfolge enthält. Sie wird destruktiv geändert, um die Ausgabestruktur zu erzeugen. |
| ppSrvURL | Ein Zeiger auf einen Zeiger für die SLPSrvURL struktur zum Empfangen der analysierten URL. Der Speicher sollte durch einen Aufruf von SLPFree () freigegeben werden, wenn er nicht mehr benötigt wird. |
Rückgabewerte
Wenn kein Fehler auftritt, lautet der Rückgabewert SLP_OK. Andernfalls wird der entsprechende Fehlercode zurückgegeben.