WSGetDomainNameList （C 関数）

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

マシン上で使用できるドメイン名を含むASCII文字列のリストと，s におけるリストの長さを返す．

詳細

  • WSGetDomainNameList()は，マシン上で使用できるアクティブネットワークインターフェースのそれぞれについて，DNSのドメイン名をロードする．
  • WSGetDomainNameList()は，解放されなければならないドメイン名を保存するためにメモリを割り当てる．WSGetDomainNameList()で割り当てられたメモリを解放するためには，WSGetDomainNameList()によって返されるリスト上でWSReleaseDomainNameList()を呼び出す．
  • WSGetDomainNameList()は，失敗した場合にはNULLを返す．
  • WSGetDomainNameList()は，WSTPヘッダファイルwstp.hの中で宣言される．

例題

例  (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);
    }
}