sepdcrec 函数获取配置信息。 应用程序调用此函数以获取用户登录到网络操作系统的名称的 3270 配置信息。 调用还会在服务表中注册此用户名。
Syntax
USHORT sepdcrec(
UCHAR *pBuffer,
USHORT length,
USHORT *numbytes
);
参数
pBuffer
指向应用程序提供的缓冲区的指针，在该缓冲区中返回配置信息。
长度
提供的缓冲区的大小。
numbytes
由 Host Integration Server 用来返回缓冲区中返回的信息字节数。
返回值
NO_ERROR （0）
OK.
NOCSSRVR （1）
没有可用的配置文件服务器。
NODGNREC （2）
在配置文件中找不到诊断记录。
NOUSRREC （3）
此用户的配置文件中找不到用户记录。
BUF2SMAL （4）
提供的缓冲区太小。
NONOS （5）
未启动网络操作系统。
NOTLOGON （6）
用户未登录到网络操作系统。
读者（7）
无法从配置文件中读取。
NONAP （8）
网络访问计划（NAP）未启动。
MAXAPP （9）
仅限 Windows：超出最大并发应用程序数。
ERROR_SERVER （14）
远程过程调用的服务器端错误（RPC）。
ERROR_LOCAL_FAILURE （15）
RPC 本地端出错。
注解
除了 SNAGetVersion 之外，应始终在任何其他 DL-BASE 或动态访问模块（DMOD）入口点之前调用 sbpuinit 函数。 对于新模拟器，应在 sbpuinit 后调用 sepdcrec。 （由于旧模拟器中使用的调用顺序，仍支持 sbpuinit 之前对 sepdcrec 的调用，但不建议使用此顺序。
成功返回时，缓冲区包含指向相应 3270 用户记录和诊断记录的指针，后跟记录本身。 其格式如下：
TECWRKUS *pUserRecord,
TEDIAGNS *pDiagRecord
);
（UserRecord - 可变长度）
（迪亚格雷科德）
应使用提供的指针访问这两条记录。
有关这些记录的格式以及应用程序如何使用配置文件信息的详细信息，请参阅 “配置信息 ”。
如果配置文件中没有此用户的 3270 个用户记录，或者配置文件中未找到任何诊断记录（内部错误），应用程序应终止，不允许用户使用 3270 仿真。 主机集成服务器错误消息COM0438和COM0437可用于报告这些故障。
如果提供的缓冲区对于返回的信息太小，则缓冲区的内容是未定义的，不应检查，但 数字 参数将包含可用信息的字节总数（即两个指针的大小加上两个配置记录）。 应用程序应以至少此大小的缓冲区重试。