Subroutine SLPFindAttrs

Online bearbeiten

Zweck

Gibt Serviceattribute zurück, die mit den Attribut-IDs für den angegebenen Service URL oder Servicetyp übereinstimmen.

Syntax

SLPError SLPFindAttrs(SLPHandle   hSLP,
                         const char *pcURLOrServiceType,
                         const char *pcScopeList,
                         const char *pcAttrIds,
                         SLPAttrCallback callback,
                         void *pvCookie);

Beschreibung

Das SLPFindAttrs unterprogramm gibt die Serviceattribute zurück, die mit den Attribut-IDs für den angegebenen Service URL oder Servicetyp übereinstimmen. Wenn pcURLOrServiceType es sich um einen Dienst URL handelt, werden die Attributinformationen für diese bestimmte Anzeige in der Sprachregion des SLPHandle zurückgegeben.

Wenn pcURLOrServiceType ein Diensttypname ist (einschließlich einer eventuellen Benennungsautorität), werden die Attribute für alle Anzeigen dieses Diensttyps unabhängig von der Sprache der Registrierung zurückgegeben. Ergebnisse werden über Callbackzurückgegeben.

Das Ergebnis wird mit einem Filterzeichenfolgeparameter für SLP-Attributanforderungen gefiltert. Wenn die Filterzeichenfolge eine leere Zeichenfolge ist (""), werden alle Attribute zurückgegeben.

Parameter

Element Beschreibung
hSLP Die SLPHandle , in der nach Attributen gesucht werden soll.
pcURLOrServiceType Der Dienst URL oder der Diensttyp. Darf keine leere Zeichenfolge sein.
pcScopeList Ein Zeiger auf ein Zeichen, das eine durch Kommas getrennte Liste von Bereichsnamen enthält. Darf nicht die leere Zeichenfolge ""sein.
pcAttrIds Die Filterzeichenfolge, die angibt, welche Attributwerte zurückgegeben werden. Verwenden Sie die leere Zeichenfolge (""), um alle Werte anzuzeigen. Platzhalterzeichen für alle Attribut-IDs mit einem bestimmten Präfix oder Suffix sind ebenfalls möglich.
Rückruf Eine Callback-Funktion, über die die Ergebnisse der Operation gemeldet werden.
pvCookie Speicher, der vom Client an den Callback-Code übergeben wird. Kann NULL sein.

Rückgabewerte

Wenn SLPFindAttrs erfolgreich ist, wird SLP_OKzurückgegeben. Wenn beim Starten der Operation ein Fehler auftritt, wird einer der SLPFehler -Codes zurückgegeben.