SLPOpen 子例程

在线编辑

用途

返回用于封装 SLP 请求的语言语言环境的 SLPHandle 句柄。

语法

SLPError SLPOpen(const char *pcLang, SLPBoolean isAsync, SLPHandle
   *phSLP);

描述

SLPOpen 子例程在作为 pcLang 参数传入的语言环境的 phSLP 参数中返回一个 SLPHandle 句柄。 客户机通过 isAsync 参数指示句柄上的操作是同步操作还是异步操作。 句柄封装通过句柄发出的 SLP 请求的语言环境以及实现所需的任何其他资源。 但是， SLP 属性不是由句柄封装的; 它们是全局的。 函数的返回值是指示操作状态的 SLPError 代码。 发生故障时， phSLP 参数为 NULL。

实现细节

SLPHandle 一次只能用于一个 SLP API 操作。 如果原始操作是异步启动的，那么在原始操作处于暂挂状态时尝试对句柄启动其他操作将导致从 API 函数返回 SLP_HANDLE_IN_USE 错误。 SLPC洛斯 () API 函数将终止句柄上的任何未完成的调用。 如果实现无法支持异步 (响应)。 同步) 操作，由于内存约束或缺少线程支持，当 isAsync 标志为 SLP_TRUE (resp) 时，可能会返回 已实现的SLP_NOT_已实现 标志。 SLP_FALSE)。

参数

项 描述
pcLang 指向字符数组的指针AIX®仅支持 "en"）。
isAsync SLPBoolean ，指示是否应为异步操作打开 SLPHandle 。 AIX 仅支持同步操作。
phSLP 一个指向 SLPHandle的指针，在该指针中返回打开的 SLPHandle 。 如果发生错误，那么返回时的值为 NULL。

返回值

如果 SLPOpen 成功，那么它将在作为 pcLang 参数传入的语言环境的 phSLP 参数中返回 SLP_OK 和 SLPHandle 句柄。

错误代码

项 描述
SLP错误 指示操作的状态