|
马上注册,结交更多好友,享用更多功能^_^
您需要 登录 才可以下载或查看,没有账号?立即注册
x
函数功能:
StringManBetXManBetXhLength 函数用于确定字符串是否超过了规定的长度,以字符为计算单位。
微软推荐使用该函数替代以下函数:
- strlen, wManBetXslen, _tManBetXslen
API 函数原型:
- HRESULT StringManBetXManBetXhLength(
- _In_ LPManBetXTSTR psz,
- _In_ size_t ManBetXManBetXhMax,
- _Out_ size_t *pManBetXManBetXh
- );
复制代码
参数解析:
参数 | 含义 | psz | 指向待检查的字符串 | ManBetXManBetXhMax | 1. psz 参数里最大允许的字符数量,包括'\0'
2. 这个数不能超过 STRSAFE_MAX_ManBetXManBetXH | pManBetXManBetXh | 1. psz 参数指向字符串的字符个数,不包括'\0'
2. 这个值只有在 psz 指针不为 NULL,且函数成功时有效 |
返回值:
这个函数返回一个 HRESULT,而不是指定字符串的字符个数。我们强烈建议您使用 和 宏来测试这个函数的返回值。
返回值可以是以下任意一个值:
返回代码 | 描述 | S_OK | psz 指向的字符串不为空,且字符串的长度(包括'\0')小于等于 ManBetXManBetXhMax | STRSAFE_E_INVALID_PARAMETER | 1. psz 指向空字符串
2. ManBetXManBetXhMax 的值大于STRSAFE_MAX_ManBetXManBetXH
3. psz 指向的字符串的字符个数超过 ManBetXManBetXhMax |
备注:
1. 对比 StringManBetXManBetXhLength 所替代的函数,StringManBetXManBetXhLength 是可以使你的代码正确处理缓存区的一个附加功能。因为小的缓冲处理会牵连很多安全问题,例如缓存区溢出
2. 使用 StringManBetXManBetXhLength 函数需要添加头文件:strsafe.h
【API档案】版权归鱼ManBetX工作室()所有,转载请注明来源。
|
|