ホーム › System.Rpc › RpcBindingToStringBindingA

RpcBindingToStringBindingA

関数

バインディングを文字列表現へ変換する(ANSI版)。

DLLRPCRT4.dll文字セットANSI (-A)呼出規約winapi対応OSWindows 2000 以降

シグネチャ

// RPCRT4.dll  (ANSI / -A)
#include <windows.h>

RPC_STATUS RpcBindingToStringBindingA(
    void* Binding,
    LPSTR* StringBinding
);

パラメーター

名前	型	方向	説明
Binding	void*	in	バインディングハンドルの文字列表現に変換する、クライアントまたはサーバーのバインディングハンドル。
StringBinding	LPSTR*	out	Binding パラメーターで指定されたバインディングハンドルの文字列表現へのポインターを指すポインターを返します。 RpcBindingToStringBinding が StringBinding パラメーターを返さないようにするには、null 値を指定します。この場合、アプリケーションは RpcStringFree 関数を呼び出しません。

名前

型

方向

説明

Binding

void*

バインディングハンドルの文字列表現に変換する、クライアントまたはサーバーのバインディングハンドル。

StringBinding

LPSTR*

out

Binding パラメーターで指定されたバインディングハンドルの文字列表現へのポインターを指すポインターを返します。

RpcBindingToStringBinding が StringBinding パラメーターを返さないようにするには、null 値を指定します。この場合、アプリケーションは RpcStringFree 関数を呼び出しません。

戻り値の型: RPC_STATUS

公式ドキュメント

RpcBindingToStringBinding 関数は、バインディングハンドルの文字列表現を返します。(RpcBindingToStringBindingA)

戻り値

値	意味
RPC_S_OK	呼び出しに成功しました。
RPC_S_INVALID_BINDING	バインディングハンドルが無効でした。

メモ有効なエラーコードの一覧については、 RPC Return Values を参照してください。

解説(Remarks)

RpcBindingToStringBinding 関数は、クライアントまたはサーバーのバインディングハンドルをその文字列表現に変換します。

RPC ランタイムライブラリは、StringBinding パラメーターで返される文字列用にメモリを割り当てます。そのメモリを解放するために RpcStringFree 関数を呼び出す責任はアプリケーションにあります。

Binding パラメーターのバインディングハンドルに nil のオブジェクト UUID が含まれていた場合、返される文字列にオブジェクト UUID フィールドは含まれません。

返された StringBinding パラメーターを解析するには、 RpcStringBindingParse 関数を呼び出します。

メモクライアントのアドレスを照会するには、アプリケーションはまず RpcBindingServerFromClient 関数を呼び出して、部分的にバインドされたサーバーバインディングハンドルを取得します。このサーバーバインディングハンドルを使用し、RpcBindingToStringBinding を呼び出すことで文字列バインディングを取得できます。その後、サーバーは RpcStringBindingParse を呼び出して、文字列バインディングからクライアントのネットワークアドレスを抽出できます。

メモ

rpcdce.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして RpcBindingToStringBinding を定義しています。エンコーディング中立なエイリアスの使用と、エンコーディング中立でないコードを混在させると、不一致が生じてコンパイルエラーまたは実行時エラーの原因となる可能性があります。詳細については、関数プロトタイプの規則を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での呼び出し定義

// RPCRT4.dll  (ANSI / -A)
#include <windows.h>

RPC_STATUS RpcBindingToStringBindingA(
    void* Binding,
    LPSTR* StringBinding
);

[DllImport("RPCRT4.dll", CharSet = CharSet.Ansi, ExactSpelling = true)]
static extern int RpcBindingToStringBindingA(
    IntPtr Binding,   // void*
    IntPtr StringBinding   // LPSTR* out
);

<DllImport("RPCRT4.dll", CharSet:=CharSet.Ansi, ExactSpelling:=True)>
Public Shared Function RpcBindingToStringBindingA(
    Binding As IntPtr,   ' void*
    StringBinding As IntPtr   ' LPSTR* out
) As Integer
End Function

' Binding : void*
' StringBinding : LPSTR* out
Declare PtrSafe Function RpcBindingToStringBindingA Lib "rpcrt4" ( _
    ByVal Binding As LongPtr, _
    ByVal StringBinding As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

RpcBindingToStringBindingA = ctypes.windll.rpcrt4.RpcBindingToStringBindingA
RpcBindingToStringBindingA.restype = ctypes.c_int
RpcBindingToStringBindingA.argtypes = [
    ctypes.POINTER(None),  # Binding : void*
    ctypes.c_void_p,  # StringBinding : LPSTR* out
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('RPCRT4.dll')
RpcBindingToStringBindingA = Fiddle::Function.new(
  lib['RpcBindingToStringBindingA'],
  [
    Fiddle::TYPE_VOIDP,  # Binding : void*
    Fiddle::TYPE_VOIDP,  # StringBinding : LPSTR* out
  ],
  Fiddle::TYPE_INT)

#[link(name = "rpcrt4")]
extern "system" {
    fn RpcBindingToStringBindingA(
        Binding: *mut (),  // void*
        StringBinding: *mut *mut u8  // LPSTR* out
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("RPCRT4.dll", CharSet = CharSet.Ansi)]
public static extern int RpcBindingToStringBindingA(IntPtr Binding, IntPtr StringBinding);
"@
$api = Add-Type -MemberDefinition $sig -Name 'RPCRT4_RpcBindingToStringBindingA' -Namespace Win32 -PassThru
# $api::RpcBindingToStringBindingA(Binding, StringBinding)

#uselib "RPCRT4.dll"
#func global RpcBindingToStringBindingA "RpcBindingToStringBindingA" sptr, sptr
; RpcBindingToStringBindingA Binding, varptr(StringBinding)   ; 戻り値は stat
; Binding : void* -> "sptr"
; StringBinding : LPSTR* out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "RPCRT4.dll"
#cfunc global RpcBindingToStringBindingA "RpcBindingToStringBindingA" sptr, var
; res = RpcBindingToStringBindingA(Binding, StringBinding)
; Binding : void* -> "sptr"
; StringBinding : LPSTR* out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "RPCRT4.dll"
#cfunc global RpcBindingToStringBindingA "RpcBindingToStringBindingA" sptr, sptr
; res = RpcBindingToStringBindingA(Binding, varptr(StringBinding))
; Binding : void* -> "sptr"
; StringBinding : LPSTR* out -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。