WSGetDomainNameList （C 函数）

char ** WSGetDomainNameList(WSENV env, unsigned long *s)

返回包含机器上可用域名的 ASCII 字符串列表和 s 中列表的长度.

更多信息

  • WSGetDomainNameList() 为每个机器上可用的有源网络界面加载 DNS 域名.
  • WSGetDomainNameList() 可为储存必须释放的域名而分配内存. 若要释放 WSGetDomainNameList() 分配的内存，可调用 WSGetDomainNameList()返回的列表上的 WSReleaseDomainNameList().
  • 失败时，WSGetDomainNameList() 返回 NULL.
  • 在 WSTP 的标头文件 wstp.h 中对 WSGetDomainNameList() 作出声明.

范例

基本范例  (1)

#include "wstp.h"

/* A function that reads the domain names available on a machine */

void f(WSENV env)
{
    char **theList = NULL;
    char *tmp;
    unsigned long length;

    theList = WSGetDomainNameList(env, &length);

    if(length > 0 && theList != (char **)0)
    {
        while((tmp = *theList++) != (char *)0)
        {
            /* ... */
        }

        WSReleaseDomainNameList(env, theList, length);
    }
}