関数 > 基本関数 >

YduOpen¶

機能¶

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

書式¶

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

パラメータ¶

wUnitID¶

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

言語	C/C++	C++/CLI	C#	VB（.NET2002以降）	VB6.0/VBA	GCC
型	WORD	unsigned short	ushort	Short	Integer	uint16_t

lpszModelName¶

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

言語	C/C++	C++/CLI	C#	VB（.NET2002以降）	VB6.0/VBA	GCC
型	LPCSTR	String^	string	String	String	const char*

wMode¶

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

定義	値	オープン時の動作
YDU_OPEN_NORMAL （省略可能）	0	デジタル出力・リレー出力が全てOFFになります
YDU_OPEN_OUT_NOT_INIT	1	デジタル出力・リレー出力の出力状態は変わりません

言語	C/C++	C++/CLI	C#	VB（.NET2002以降）	VB6.0/VBA	GCC
型	WORD	unsigned short	ushort	Short	Integer	uint16_t

戻り値¶

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

言語	C/C++	C++/CLI	C#	VB（.NET2002以降）	VB6.0/VBA	GCC
型	INT	int	int	Integer	Long	int32_t

備考¶

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

例

型番 lpszModelNameに指定する型番

RLY-24/16/32A-U (35V) RLY-24/16/32A-U

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

使用例¶

例1
IDが0に設定されているRLY-24A-Uをオープンします。リレー出力は全てOFFになります。
例2
IDが0に設定されているRLY-24A-Uをオープンします。リレー出力の状態は関数実行前と変わりません。

C/C++¶

// 例1
int nResult;
nResult = YduOpen(0, "RLY-24A-U");

// 例2
int nResult;
nResult = YduOpen(0, "RLY-24A-U", YDU_OPEN_OUT_NOT_INIT);

C++/CLI¶

// 例1
int result;
result = YduOpen(0, "RLY-24A-U");

// 例2
int result;
result = YduOpen(0, "RLY-24A-U", YDU_OPEN_OUT_NOT_INIT);

C#¶

// 例1
int result;
result = Ydu.Open(0, "RLY-24A-U");

// 例2
int result;
result = Ydu.Open(0, "RLY-24A-U", Ydu.YDU_OPEN_OUT_NOT_INIT);

VB（.NET2002以降）¶

' 例1
Dim result As Integer
result = YduOpen(0, "RLY-24A-U")

' 例2
Dim result As Integer
result = YduOpen(0, "RLY-24A-U", YDU_OPEN_OUT_NOT_INIT)

VB6.0/VBA¶

' 例1
Dim lngResult As Long
Dim strModelName as String
strModelName = "RLY-24A-U"
lngResult = YduOpen(0, strModelName)

' 例2
Dim lngResult As Long
Dim strModelName as String
strModelName = "RLY-24A-U"
lngResult = YduOpen(0, strModelName, YDU_OPEN_OUT_NOT_INIT)

GCC¶

// 例1
int32_t result;
result = YduOpen(0, "RLY-24A-U");

// 例2
int32_t result;
result = YduOpen(0, "RLY-24A-U", YDU_OPEN_OUT_NOT_INIT);