関数 > 基本関数 >

YduOpen

機能

ユニットのオープンをおこない、ユニットへのアクセスをおこなえるようにします。

書式

INT YduOpen(
    WORD wUnitID,
    LPCSTR lpszModelName,
    WORD wMode = YDU_OPEN_NORMAL
);

パラメータ

wUnitID

オープンするユニットのID番号を指定します。

言語 C/C++ C++/CLI C# VB(.NET2002以降) VB6.0
WORD unsigned short ushort Short Integer

lpszModelName

オープンするユニットの型名を指定します(備考も参照してください)。

言語 C/C++ C++/CLI C# VB(.NET2002以降) VB6.0
LPCSTR String^ string String String

wMode

オープン時の動作を指定します。

定義 オープン時の動作
YDU_OPEN_NORMAL
(省略可能)
0 デジタル出力・リレー出力が全てOFFになります
YDU_OPEN_OUT_NOT_INIT 1 デジタル出力・リレー出力の出力状態は変わりません
言語 C/C++ C++/CLI C# VB(.NET2002以降) VB6.0
WORD unsigned short ushort Short Integer

戻り値

関数が正常に終了した場合は0(YDU_RESULT_SUCCESS)が返ります。
オープンに失敗した場合は0以外が返りますので、その場合はエラーコードを参照してください。

言語 C/C++ C++/CLI C# VB(.NET2002以降) VB6.0
INT int int Integer Long

備考

型番末尾に (35V) または (50V) が付加されている型番の場合、lpszModelNameには (35V) または (50V) を除いた型番を指定してください。

  • 型番 lpszModelNameに指定する型番
    PMC-S4/16/32A-U (35V) PMC-S4/16/32A-U

YduOpen関数でオープンしたユニットは、アプリケーション終了時に必ずYduClose関数でクローズしてください

使用例

  • 例1
    IDが0に設定されているPMC-S4/00/00A-Uをオープンします。デジタル出力は全てOFFになります。

  • 例2
    IDが0に設定されているPMC-S4/00/00A-Uをオープンします。デジタル出力の状態は関数実行前と変わりません。

C/C++

// 例1
int nResult;
nResult = YduOpen(0, "PMC-S4/00/00A-U");

// 例2
int nResult;
nResult = YduOpen(0, "PMC-S4/00/00A-U", YDU_OPEN_OUT_NOT_INIT);

C++/CLI

// 例1
int result;
result = YduOpen(0, "PMC-S4/00/00A-U");

// 例2
int result;
result = YduOpen(0, "PMC-S4/00/00A-U", YDU_OPEN_OUT_NOT_INIT);

C#

// 例1
int result;
result = Ydu.Open(0, "PMC-S4/00/00A-U");

// 例2
int result;
result = Ydu.Open(0, "PMC-S4/00/00A-U", Ydu.YDU_OPEN_OUT_NOT_INIT);

VB(.NET2002以降)

' 例1
Dim result As Integer
result = YduOpen(0, "PMC-S4/00/00A-U")

' 例2
Dim result As Integer
result = YduOpen(0, "PMC-S4/00/00A-U", YDU_OPEN_OUT_NOT_INIT)

VB6.0

' 例1
Dim lngResult As Long
Dim strModelName as String
strModelName = "PMC-S4/00/00A-U" & Chr(0)
lngResult = YduOpen(0, strModelName)

' 例2
Dim lngResult As Long
Dim strModelName as String
strModelName = "PMC-S4/00/00A-U" & Chr(0)
lngResult = YduOpen(0, strModelName, YDU_OPEN_OUT_NOT_INIT)