SLPFindSrvTypesサブルーチン

オンライン編集

目的

SLP サービス・タイプ要求を発行します。

構文

SLPError SLPFindSrvTypes(SLPHandle    hSLP,
                            const char  *pcNamingAuthority,
                            const char  *pcScopeList,
                            SLPSrvTypeCallback callback,
                            void *pvCookie);

説明

SLPFindSrvType()サブルーチンは、pcScopeListによって示されるスコープ内のサービスタイプに対して、SLPサービスタイプ要求を発行する。 結果は、 コールバック パラメーターを介して返されます。 サービスタイプは言語ロケールに依存しないが、いずれかのスコープに登録されたサービスと、pcNamingAuthorityで示される命名機関にのみ適用される。

命名権限が "*"の場合は、すべての命名権限について結果が戻されます。 命名権限が空ストリング ""の場合は、デフォルトの命名権限 "IANA"が使用されます。 "IANA" は有効な命名権限名ではなく、明示的に組み込まれると PARAMETER_BAD エラーを返します。

サービス・タイプ名は、命名権限を変更せずに戻されます。 命名権限がデフォルト (つまり、空ストリング) の場合は、分離する "."と同様に、この権限は省略されます。 service: スキームの URL からのサービス・タイプ名は、 "service:" 接頭部をそのまま使用して返されます。

パラメーター

項目 説明
hSLP タイプの検索に使用する SLPHandle (LPHandle) 。
pcNamingAuthority 検索する命名権限。 すべての命名権限には "*" を使用し、デフォルトの命名権限には空ストリング ""を使用します。
pcScopeList サービス・タイプを検索するためのスコープ名のコンマ区切りリストを含む文字へのポインター。 空ストリング ""にすることはできません。
コールバック 操作の結果の報告に使用されるコールバック関数。
pvCookie クライアントからコールバック・コードに渡されるメモリー。 NULL にすることができます。

戻り値

SLPFindSrvTypesが成功すると、SLP_OKを返す。 操作の開始中にエラーが発生した場合は、 SLPError (LPError) コードの 1 つが返されます。