>Of course I'vd not gotten into the api yet. Mostly from fear of screwing up.

Why? What's the worst that could happen, "Data Type Mismatch"? "Too few arguments"? Okay, maybe the application crashes, big deal. Carpe diem, I say! DECLARE that function and call it!