Функция обратного вызова LPNSPSPLOOKUPSERVICEBEGIN (ws2spi.h)

Функция NSPLookupServiceBegin инициирует клиентский запрос поставщика службы имен, ограниченный сведениями, содержащимися в структуре WSAQUERYSET .

NSPLookupServiceBegin возвращает только дескриптор, который должен использоваться при последующих вызовах NSPLookupServiceNext для получения фактических результатов. Так как эту операцию нельзя отменить, ее необходимо реализовать для быстрого выполнения. Хотя можно инициировать сетевой запрос, эта функция не должна требовать ответа для успешного возврата.

Синтаксис

LPNSPLOOKUPSERVICEBEGIN Lpnsplookupservicebegin;

INT Lpnsplookupservicebegin(
  [in]  LPGUID lpProviderId,
  [in]  LPWSAQUERYSETW lpqsRestrictions,
  [in]  LPWSASERVICECLASSINFOW lpServiceClassInfo,
  [in]  DWORD dwControlFlags,
  [out] LPHANDLE lphLookup
)
{...}

Параметры

[in] lpProviderId

Указатель на идентификатор поставщика услуг имени для запроса.

[in] lpqsRestrictions

Указатель на условия поиска. См. заметки.

[in] lpServiceClassInfo

Указатель на структуру WSASERVICECLASSINFO , содержащую сведения о схеме для службы.

[in] dwControlFlags

Значение типа , определяющее глубину поиска.

[out] lphLookup

Указатель на дескриптор, используемый в последующих вызовах NSPLookupServiceNext для получения набора результатов.

Возвращаемое значение

Функция должна возвращать NO_ERROR (ноль), если подпрограмма завершается успешно. Он должен вернуть SOCKET_ERROR (–1), если подпрограмма завершается сбоем, и она должна задать соответствующий код ошибки с помощью WSASetLastError.

Комментарии

Если в вызове указано LUP_CONTAINERS, избегайте других значений ограничений. Если они предоставляются, поставщик службы имен должен решить, может ли он поддерживать это ограничение для контейнеров. В противном случае он должен возвращать ошибку.

Некоторые поставщики служб имен могут иметь другие средства поиска контейнеров. Например, все контейнеры могут иметь известный тип или набор хорошо известных типов, поэтому для их поиска можно создать ограничение запросов. Независимо от того, какие другие средства имеет поставщик службы имен для поиска контейнеров, приоритет имеют LUP_CONTAINERS и LUP_NOCONTAINERS . Таким образом, если задано ограничение запроса, включающее контейнеры, указание LUP_NOCONTAINERS будет препятствовать возврату элементов контейнера. Аналогичным образом, независимо от ограничения запроса, если задано LUP_CONTAINERS , должны возвращаться только контейнеры. Если пространство имен не поддерживает контейнеры и указано LUP_CONTAINERS , оно должно вернуть WSANO_DATA.

Предпочтительным методом получения контейнеров в другом контейнере является вызов:

dwStatus = NSPLookupServiceBegin(
    lpqsRestrictions,
    LUP_CONTAINERS,
    lphLookup);

за которым следует необходимое количество вызовов NSPLookupServiceNext . При этом будут возвращены все контейнеры, содержащиеся непосредственно в начальном контексте; то есть это не глубокий запрос. С помощью этого можно сопоставить структуру адресного пространства, проходя по иерархии, возможно, перечисляя содержимое выбранных контейнеров. Последующие методы NSPLookupServiceBegin используют контейнеры, возвращенные при предыдущем вызове.

Формирование запросов

Как уже упоминалось, структура WSAQUERYSET используется в качестве входного параметра для NSPLookupServiceBegin для квалификации запроса. В следующей таблице перечислены имена членов WSAQUERYSET и описано, как WSAQUERYSET используется для создания запроса. Если элемент помечен как (необязательный), можно указать пустой указатель, указывающий, что параметр не будет использоваться в качестве условий поиска. Дополнительные сведения см. в разделе Структуры данных, связанные с запросами.

Требования

См. также раздел

AFPROTOCOLS

NSPLookupServiceEnd

NSPLookupServiceNext

NSP_ROUTINE

WSAQUERYSET

WSASERVICECLASSINFO

WSASetLastError